home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 26 / AMIGAplus Sonderheft 26 (2000)(Falke)(DE)(Track 1 of 2)[!].iso / Tools / SFX-Player / AmigaAMP / AmigaAMP.readme < prev    next >
Text File  |  1999-03-29  |  17KB  |  437 lines
  1. Short:    MPEG audio player with GUI (68k/PPC)
  2. Uploader: Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  3. Author:   Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  4. Type:     mus/play
  5. Version:  2.2
  6.  
  7. Homepage
  8. --------
  9. http://amigaamp.amiga-software.com
  10.  
  11.  
  12. Introduction
  13. ------------
  14. AmigaAMP is a GUI based MPEG audio player using mpega.library on the 68k
  15. processor or the amp decoding engine in the PPC version.  Sound is played
  16. back using the AHI audio system.  AmigaAMP is NOT another frontend for the
  17. CLI based mpega.  Anyway, if you've got problems not related to the user
  18. interface but with AHI, AsyncIO or mpega.library, PLEASE contact the
  19. corresponding author directly.  I wouldn't be able to help you in this
  20. case.
  21.  
  22.  
  23. Requirements (not included in this archive!)
  24. --------------------------------------------
  25. AmigaOS 3.0 or higher
  26. 68030-50MHz processor or better
  27. mpega.library    (Aminet:util/libs/mpega_library.lha)
  28. asyncio.library  (Aminet:dev/c/AsyncIO.lha)
  29. AHI audio system (Aminet:mus/misc/ahiusr.lha)
  30.  
  31.  
  32. Recommended
  33. -----------
  34. PowerUP and ppc.library v46
  35. AmigaOS 3.1 (OS3.1 AND PowerUP v46 are needed for the spectrum analyzer!)
  36.  
  37. Features
  38. --------
  39.  - FREEWARE!  No beta, no nag requesters and no expiry date!
  40.  - GadTools based font sensitive user interface
  41.  - Alternatively WinAMP compatible user interface
  42.  - Fast, synchronous spectrum analyzer (almost no latency)
  43.  - Workbench application (you can drop icons on its window)
  44.  - Easily configurable
  45.  - AHI device-level access (uses default audio mode automatically)
  46.  - PPC (PowerUP) support
  47.  - ID3 tag editor (artist, title, albm, etc.)
  48.  
  49. Limitations
  50. -----------
  51.  - The PPC version doesn't support MPEG2.5 yet, I'm working on it
  52.  - Only simple level meters in the 68k version
  53.  - No realtime spectrum when using AmigaOS 3.0 -- sorry guys!
  54.  - No realtime spectrum when playing MP2 files yet
  55.  
  56. History
  57. -------
  58. v2.2  - better CyberGraphX compatibility
  59.       - editable playlist including loading and saving (from the menu)
  60.       - time/remain display
  61.       - freaky animation in the bottom right corner :)
  62.       - autoscrolling song/artist text in WinAMP mode
  63.       - skin display while loading on highcolor/truecolor screens
  64.       - random play (shuffle)
  65.       - more alphabetically sorted genres
  66.       - key sensitive genre requester
  67.       - pitch shift (+ and - keys on numeric keypad, * resets speed)
  68.       - improved PUBSCREEN and SCREENMODE capabilities
  69.       - fixed internal crossfader
  70.         Start two aamps and hold shift while dragging the volume slider
  71.       - support for 'nums_ex' and 'volbar' named skin images
  72.  
  73. v2.1  - configurable playback buffer size (should cure many problems!)
  74.       - fixed a bug that caused truecolor skins to be dithered even on
  75.         truecolor screens
  76.       - Skin pictures can have any extension you like as long as the name
  77.         is correct.
  78.       - Fixed a bug in the PPC loader for 48 kHz MPEGs
  79.       - asynchronous filerequester
  80.       - Skins can be reloaded at any time.
  81.       - auto-play after opening a file if playback was active before opening
  82.       - corrected some skin positions
  83.       - visualisation for the 68k version, too (level meters)
  84.       - MaxFreq finally works
  85.  
  86. v2.0  - so many changes it was worth bumping the version number :-)
  87.       - position of genre listview gadget fixed
  88.       - fixed bugs when playing mono or 22.05 kHz files
  89.       - digital volume control
  90.       - AREXX interface (see AREXX.readme)
  91.       - automatic detection if another AmigaAMP task is already
  92.         running
  93.       - alphabetically sorted playlist (not editable yet)
  94.       - configurable buffersize
  95.       - WinAMP lookalike GUI (see below)
  96.       - Improved fontsensitivity of old GUI
  97.       - cached taginfo -- will be written when the file is closed
  98.  
  99. v1.1  - name changed to AmigaAMP
  100.       - PPC version
  101.       - ID3 tag editor
  102.       - commandline support
  103.  
  104. v1.0  - initial release called MPEGAHI
  105.  
  106. Getting started (configuration)
  107. -------------------------------
  108. Important! You need a properly installed and configured AHI audio system
  109. to run AmigaAMP. Without a correct setup the sound may be very poor and
  110. AHI will draw too much CPU power!
  111.  
  112. First of all run the AHI setup program in your Prefs drawer. Select
  113. one of the units from 0 to 3 but not the Music unit. If you don't use
  114. unit 0 for anything already I recommend using that one.
  115.  
  116. Select one of the "fast stereo++" audiomodes that matches your audio
  117. hardware. For Prelude playback I recommend "Prelude:Fast 16 bit stereo++
  118. realtime".
  119.  
  120. Now you need to know what sampling rate most of your MPEG files
  121. have. Probably it's 44100 Hz because that's the standard CD rate. If
  122. you have a slow processor you may want to run AmigaAMP in frequency division
  123. mode to reduce CPU load. Have a look at the table below for the recommended
  124. settings.
  125.  
  126. It is important to set the frequency slider to your mostly used frequency
  127. divided by your chosen frequency divisor. For example, if you're going to
  128. playback lots of 44100 Hz MPEGs and frequency division is 1:2, set the
  129. Frequency slider to 22050 Hz.
  130.  
  131. If you don't plan to have several programs playing back audio at the
  132. same time, please leave the Channels slider at position 1. The remaining
  133. settings depend on your audio hardware.
  134.  
  135. Ok, press the "Save" button in the bottom left corner.
  136.  
  137. Now it's time to configure AmigaAMP itself. If you've chosen another
  138. AHI device than 0, you have to change the AHIUNIT tooltype of AmigaAMP
  139. first. If not, just start it by double clicking on its icon and pop up
  140. the setup window by chosing Config... from the menu.
  141.  
  142. Set the sliders and checkmarks to the recommended settings, save them using
  143. the menu and close the settings window again.
  144.  
  145. That's it! AmigaAMP is now configured. You may want to fine-tune the
  146. settings later. The overall performance depends on the speed of mpega.library
  147. AND the the speed of your soundcard's AHI driver.
  148.  
  149. Recommended settings (tested with Prelude:Fast 16 bit stereo++ realtime)
  150. ------------------------------------------------------------------------
  151.  
  152.           |     Layer 1/2        |        Layer 3
  153. Processor | Quality|FreqDiv|Mono | Quality|FreqDiv|Mono
  154. ----------+--------+-------+-----+--------+-------+-----
  155. 68040-40  |  high  |  1:2  | off | medium |  1:2  | on 
  156. 68060-50  |  high  |  1:1  | off |  high  |  1:1  | off
  157. PPC604e   |  high  |  1:1  | off |  high  |  1:1  | off
  158.  
  159. Note: In fact only the 68k version is affected by these settings.
  160.  
  161.  
  162. Advanced settings
  163. -----------------
  164. * Bufsize:
  165. Set the size of the read ahead buffer. Try playing with it until you
  166. get best results. (Normally 16 to 32K is best)
  167. Setting the buffersize to FILE means that the read ahead buffer will
  168. be as large as the current track eliminating all disk access during
  169. play. Attention! This option isn't 100% stable yet!
  170.  
  171. * TaskPri:
  172. Set the running task priority of AmigaAMP. The recommended value for
  173. uninterrupted playback is 1. God knows what happens if some 3rd party
  174. task rescheduler starts fiddling around with AmigaAMP's internal task
  175. priorities...
  176.  
  177. * Read ID3 TagInfo
  178. Try to read information about artist, title, etc. Because those are stored
  179. at the end of the file it may slow down loading a bit. If this function
  180. is switched off, TagInfo can neither be edited nor saved!
  181.  
  182. * Allow multiple instances
  183. Normally when you click on an MPEG file project icon while AmigaAMP is
  184. already playing another one, no second AmigaAMP task will be launched but
  185. the already running task will start playing the new file. This behaviour
  186. can be switched off. You have to start AmigaAMP twice manually and then
  187. save the config with "Allow multiple instances" switched on from both
  188. running tasks.
  189.  
  190. * Limit volume to 0dB
  191. The volume slider ranges from silence to +6dB volume so that you can boost
  192. more silent recordings. If you don't want to turn the volume above normal
  193. accidentally, you can switch on this option.
  194.  
  195. * ToolType: DIRECTORY
  196. Default directory to display in filerequester.
  197.  
  198. * ToolType/Keyword: SCREENMODE
  199. Tell AmigaAMP to use its own screen. The mode has to be specified in
  200. decimal or hexadecimal format. Hex values have to be preceeded by
  201. <0x> or <$>. Example: SCREENMODE=0x50021303
  202.  
  203. * ToolType/Keyword: PUBSCREEN
  204. Name of the public screen that AmigaAMP will display its GUI on.
  205. Example: PUBSCREEN=DOPUS.1
  206.  
  207. Usage (how to load and play sounds)
  208. -----------------------------------
  209. Most of the buttons should be self-explanatory because they can be found
  210. on almost every CD player or tapedeck. However, as a computer program,
  211. AmigaAMP is based on files, so there may be slight differences. The bottom
  212. line buttons from left to right are:
  213.  
  214.  - Eject      Stops playback, empties the current playlist and opens a
  215.               requester to select one or more files
  216.  - Skip back  Moves to the previous track in the playlist if there is one.
  217.  - Stop       Simply stops playback. (What else did you expect? :-)
  218.  - Play       Starts playback if there's at least one track in the current
  219.               playlist. If it's not, opens a requester to select tracks.
  220.  - Skip fwd   Moves to the next track in the playlist if there is one.
  221.  - Pause      Pauses playback at the current position
  222.  
  223. Just above the control button's there's a position slider. As you play
  224. a file, it's button moves from left to right to display the relative
  225. playback position within the current track. You can use the mouse to drag
  226. this slider to a new position.
  227.  
  228. Keyboard shortcuts
  229. ------------------
  230. CURSOR RIGHT        skip 10s forward
  231. CURSOR LEFT         skip 10s backward
  232. CURSOR UP           increase volume
  233. CURSOR DOWN         decrease volume
  234. SPACE               play/stop
  235. P                   pause
  236. NUM +               increase speed by one semitone
  237. NUM -               decrease speed by one semitone
  238. NUM *               normal playback speed
  239. Z                   skip back one track
  240. X                   play
  241. C                   pause
  242. V                   stop
  243. B                   skip fwd one track
  244. N                   eject
  245.  
  246. About the WinAMP GUI
  247. --------------------
  248. Since WinAMP v1.80 you can load customizeable textures (so called skins) for
  249. the GUI. The skins consist of several bitmapped pictures together in one
  250. directory and contain the the look of the window itself as well as images
  251. for all the gadgets. Because more and more people ask me to make AmigaAMP
  252. look like WinAMP I now included an alternative GUI routine that can load
  253. those WinAMP skins!
  254.  
  255. I've included my three favourite examples in the "skins" directory. There
  256. are three subdirectories called
  257.  
  258.  - base      -> the original WinAMP design
  259.  - sex       -> a very colourful appearance :-)
  260.  - eXquisite -> wood case and polished brass knobs :)
  261.  
  262. To activate one of those GUIs you have to start AmigaAMP with the options
  263. NewGUI and Skin=<subdirectory name>. If you just want the WinAMP like basic
  264. look you can simply type "AmigaAMP NG" where NG is the shortcut for NewGUI.
  265. For the other designs a highcolor display mode on a graphics card
  266. is strongly recommended.
  267.  
  268. Although the pictures all have the extension .iff they can be any format
  269. that you have a datatype for. If you find a working BMP datatype (try
  270. loading the pictures with multiview first) you can even copy WinAMP skins
  271. direcly. AmigaAMP will try to load pictures with the extensions iff or bmp
  272. automatically.
  273.  
  274. At the moment not everything of the WinAMP GUI is really functional. For
  275. example there's no spectrum analyzer for MP2, no graphic EQ and the shuffle
  276. button won't work either. Anyway, most of the rest is working!
  277.  
  278.  
  279. Legal stuff
  280. -----------
  281. AmigaAMP is copyrighted freeware. It may be distributed freely as long as
  282. no modifications are made to the executable and this document. A nominal
  283. fee may be asked to cover distribution costs.
  284.  
  285. AmigaAMP may not be used for any commercial purposes or included with any
  286. commercial product without the written permission of the author. It may not
  287. be advertised, offered or distributed together or in conjunction with
  288. commercial products. The only exception is the Aminet archive.
  289.  
  290. No responsibilities are taken for damaged speakers, amplifiers, Amigas
  291. or any other components or data involved while using AmigaAMP.
  292.  
  293. Although I've done some beta testing I can't guarantee that AmigaAMP will
  294. not crash! If you find any bugs, let me know.
  295.  
  296. Here's the original amp.readme:
  297. -------------------------------
  298. amp MPEG audio decoder readme file (version 0.7.5)
  299. (C) Tomislav Uzelac  1996,1997
  300.  
  301. amp is free software and can be _used_ freely by anyone. If you want to
  302. do anything else with it, be sure to check the Legal section of this
  303. document for legal issues.
  304.  
  305. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  306. of this document.
  307.  
  308. 1. Introduction
  309. 2. Installation
  310. 3. Running
  311. 4. Feedback
  312. 5. Contributing
  313. 6. Legal
  314.  
  315.  
  316. 1. Introduction
  317.  
  318. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  319. putting together as a side project of the MPEG hardware design project at 
  320. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  321. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  322. defined in MPEG2), layers 2 and 3. 
  323.  
  324. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  325. available at the amp home site ftp://ftp.rasip.fer.hr
  326.  
  327. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  328.  
  329. The following people contributed their time and knowledge to amp:
  330. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  331. Edouard Lafargue, Andrew Richards, George Colouris,
  332. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  333.  
  334. amp home location is
  335.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  336.  
  337. and the mailing list: send 'HELP' in the body of the message to:
  338.     multimedia@rasip.fer.hr
  339.  
  340. If you want to find out more about MPEG, best places to start are
  341.     http://www.mpeg.org
  342.     http://www.mpeg2.de 
  343.  
  344.  
  345. 2. Installation
  346.  
  347. Installation should be simple enough if amp was ported to your system,
  348. just do a 
  349.  
  350. ./configure
  351. make 
  352.  
  353. You can edit the makefile further to suit your system. If configure fails 
  354. to make a usable Makefile, you'll _have_ to edit it yourself.
  355.  
  356. Linux users should try real-time playing support, as described
  357. in doc/realtime.txt. Some people that might pass on this feature are
  358. those with slower machines (i.e. 486's), or SMP systems (see the
  359. doc/linuxrealtime.txt file). 
  360. Some versions of the linux C library produce an error when compiling
  361. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  362. and replace _P in the offending line with __P.
  363.  
  364. ./configure --enable-realtime
  365. make
  366. chown root.root amp
  367. chmod u+s amp
  368.  
  369. ... this requires /dev/dsp to be both world readable and writeable. If you
  370. have a special group for people allowed to use the sound device (for
  371. instance, a group called sound), you can do a:
  372.  
  373. chmod g+s amp
  374.  
  375. or make your audio card world read/writeable (not recomended)
  376.  
  377. chmod o+rw /dev/dsp*
  378.  
  379. 3. Running:
  380.  
  381. 'amp -h' gives you usage & options. If your computer is on the slower
  382. side, direct playback might not work, but you can decode it
  383. to .wav or raw pcm and play it later.
  384.  
  385.  
  386. 4. Feedback
  387.  
  388. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  389. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  390.  
  391. If you find any mpeg audio files that amp has trouble decoding, please tell
  392. me about this via e-mail <tuzelac@rasip.fer.hr>.
  393.  
  394.  
  395. 5. Contributing
  396.  
  397. Please contribute to amp. If you want to know what is going on in amp 
  398. development, you can join the developers mailing list
  399.  
  400.     mpeg_audio_developers@rasip.fer.hr
  401.  
  402. There are certain debugging facilities that I made in amp, but are disabled
  403. in the current release (they are neither nice nor user-friendly). If anyone
  404. enhances them (they are in dump.c) to the point that they're actually
  405. usable I'll be happy to include the changes in the release. I think this
  406. kind of debug output would be very useful to people studying these audio
  407. algorithms.
  408.  
  409.  
  410. 6. Legal
  411.  
  412. This software can be used freely for any purpose. It can be distributed
  413. freely, as long as it is not sold commercially without permission from
  414. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  415. on CD_ROMs containing other free software is explicitly permitted even 
  416. when a modest distribution fee is charged for the CD, as long as this
  417. software is not a primary selling argument for the CD.
  418.  
  419. Building derived versions of this software is permitted, as long as they
  420. are not sold commercially without permission from Tomislav Uzelac 
  421. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  422. such, and must be called by a name other than amp. Any derived versions
  423. must retain this copyright notice.
  424.  
  425. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  426.  * not mention being copyrighted itself :)
  427.  */
  428.  
  429. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  430. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  431. any damages that might occur to your computer, software, etc. in
  432. consequence of you using this freeware program.
  433.  
  434.  
  435. Tomislav Uzelac
  436. <tuzelac@rasip.fer.hr>
  437.